The following list describes the events that can be linked to the actions listed in the Behavior inspector's Actions (+) pop-up menu. When a visitor to your Web page interacts with the page—for example, by clicking an image—the browser generates events; those events can be used to call JavaScript functions that cause an action to occur. (Events can also be generated without user interaction, such as when you set a page to automatically reload every 10 seconds.) Dreamweaver supplies many common actions that you can trigger using these events.
The list also specifies which browsers can generate each event. NS3 means Netscape Navigator 3.0; NS4 means Netscape Navigator 4.0; IE3 means Internet Explorer 3.0; IE4 means Internet Explorer 4.0. For information about 5.0 browsers, see the Dreamweaver Support Center. For pointers to more information about events relating to data binding and marquees in Internet Explorer, see Microsoft's Dynamic HTML reference page .
Note that most events don't apply to all objects. For details on which events apply to which tags in each browser, see the files in your Dreamweaver/Configuration/Behaviors/Events folder.
onAbort (NS3, NS4, IE4) is generated when the user stops the browser from completely loading an image (for example, when the user clicks the browser's Stop button while an image is loading).
onAfterUpdate (IE4) is generated when a bound data element on the page has finished updating the data source.
onBeforeUpdate (IE4) is generated when a bound data element on the page has been changed and is about to lose focus (and is therefore about to update the data source).
onBlur (NS3, NS4, IE3, IE4) is the opposite of onFocus
. The onBlur
event is generated when the specified element stops being the focus of user interaction. For example, when a user clicks outside a text field after clicking in the text field, the browser generates an onBlur
event for the text field.
onBounce (IE4) is generated when a marquee element's contents have reached the boundary of the marquee.
onChange (NS3, NS4, IE3, IE4) is generated when the user changes a value on the page, such as when the user chooses an item from a menu, or when the user changes the value of a text field and then clicks elsewhere on the page.
onClick (NS3, NS4, IE3, IE4) is generated when the user clicks the specified element, such as a link, button, or image map. (Clicking is defined as pressing and then releasing the mouse button while pointing to the element.)
onDblClick (NS4, IE4) is generated when the user double-clicks the specified element. (Double-clicking is defined as quickly pressing and releasing the mouse button while pointing to the element.)
onError (NS3, NS4, IE4) is generated when a browser error occurs while a page or image is loading.
onFinish (IE4) is generated when the contents of a marquee element have completed a loop.
onFocus (NS3, NS4, IE3, IE4) is generated when the specified element becomes the focus of user interaction. For example, clicking in a text field of a form generates an onFocus
event.
onHelp (IE4) is generated when the user clicks the browser's Help button or chooses Help from a browser menu.
onKeyDown (NS4, IE4) is generated as soon as the user presses any key. (The user does not have to release the key for this event to be generated.)
onKeyPress (NS4, IE4) is generated when the user presses and releases any key; this event is like a combination of the onKeyDown
and onKeyUp
events.
onKeyUp (NS4, IE4) is generated when the user releases a key after pressing it.
onLoad (NS3, NS4, IE3, IE4) is generated when an image or page finishes loading.
onMouseDown (NS4, IE4) is generated when the user presses the mouse button. (The user does not have to release the mouse button to generate this event.)
onMouseMove (IE3, IE4) is generated when the user moves the mouse while pointing to the specified element. (That is, the pointer stays within the boundaries of the element.)
onMouseOut (NS3, NS4, IE4) is generated when the pointer moves off the specified element. (The specified element is usually a link.)
onMouseOver (NS3, NS4, IE3, IE4) is generated when the mouse first moves to point to the specified element. (That is, when the pointer moves from not pointing to the element to pointing to the element.) The specified element for this event is usually a link.
onMouseUp (NS4, IE4) is generated when a pressed mouse button is released.
onMove (NS4) is generated when a window or frame moves.
onReadyStateChange (IE4) is generated when the state of the specified element changes. Possible element states include uninitialized
, loading
, and complete
.
onReset (NS3, NS4, IE3, IE4) is generated when a form is reset to its default values.
onResize (NS4, IE4) is generated when the user resizes the browser window or a frame.
onRowEnter (IE4) is generated when the current record pointer of the bound data source has changed.
onRowExit (IE4) is generated when the current record pointer of the bound data source is about to change.
onScroll (IE4) is generated when the user scrolls up or down.
onSelect (NS3, NS4, IE3, IE4) is generated when the user selects text in a text field.
onStart (IE4) is generated when a marquee element's contents begin a loop.
onSubmit (NS3, NS4, IE3, IE4) is generated when the user submits a form.
onUnload (NS3, NS4, IE3, IE4) is generated when the user leaves the page.